home *** CD-ROM | disk | FTP | other *** search
/ Total Web Page (Professional Suite) / Total Web Page 99.iso / CGI / DOWNLOAD.CGI-S=RAND_LINK&C=TXT&F=README < prev    next >
Text File  |  1996-06-03  |  6KB  |  105 lines
  1. ##############################################################################
  2. # Random Link                   Version 1.0                                  #
  3. # Copyright 1996 Matt Wright    mattw@worldwidemart.com                      #
  4. # Created 7/15/95               Last Modified 7/30/95                        #
  5. # Scripts Archive at:           http://www.worldwidemart.com/scripts/        #
  6. ##############################################################################
  7. # If you run into any problems while trying to configure this scripts, help  #
  8. # is available.  The steps you should take to get the fastest results, are:  #
  9. #       1) Read this file thoroughly                         #
  10. #       2) Consult the Matt's Script Archive Frequently Asked Questions:     #
  11. #               http://www.worldwidemart.com/scripts/faq/                 #
  12. #       3) If you are still having difficulty installing this script, send   #
  13. #          e-mail to: scripts-help@tahoenet.com                     #
  14. #          Include any error messages you are receiving and as much detail   #
  15. #          as you can so we can spot your problem.  Also include the variable#
  16. #          configuration block that is located at the top of the script.     #
  17. #                                         #
  18. # Hopefully we will be able to help you solve your problems.  Thank you.     #
  19. ##############################################################################
  20. # COPYRIGHT NOTICE                                                           #
  21. # Copyright 1996 Matthew M. Wright  All Rights Reserved.                     #
  22. #                                                                            #
  23. # Random Link may be used and modified free of charge by anyone so long as   #
  24. # this copyright notice and the comments above remain intact.  By using this #
  25. # code you agree to indemnify Matthew M. Wright from any liability that      #
  26. # might arise from it's use.                                                 #
  27. #                                                                            #
  28. # Selling the code for this program without prior written consent is         #
  29. # expressly forbidden.  In other words, please ask first before you try and  #
  30. # make money off of my program.                                              #
  31. #                                                                            #
  32. # Obtain permission before redistributing this software over the Internet or #
  33. # in any other medium.  In all cases copyright and header must remain intact.#
  34. ##############################################################################
  35.  
  36. This Random Link Script was originally written to be part of my Free For All 
  37. Links Script, but I thought that I could also break it down and send it out as 
  38. a small script for those people wanting to run their own Random Link Page.  It 
  39. should be relatively easy to set up. 
  40. =====================================================================
  41.  
  42. There are three files included in this package.  They are:
  43.         README          - This file
  44.         rand_link.pl    - The Perl File that calls the Random Link
  45.         rand_link.html  - An Example HTML of how to call the script
  46.         rand_log        - A blank log file
  47.  
  48. =====================================================================
  49.  
  50. This is one of the more simple scripts that I have written and it only has one 
  51. variable that you must set up and another if you choose to use the logging 
  52. option.
  53.  
  54. RAND_LINK.PL
  55.         This file must be placed in the cgi-bin of your server and chmoded to 
  56. 755, so that it is readable and executable by all users.  There is one 
  57. variable in here, described below:
  58.  
  59.                 # Variables
  60.                 $linkfile = "";
  61.                         This is the database of links.  Links must be
  62.                         placed in this database, without any markup,
  63.                         one per line.
  64.  
  65.                 # Options
  66.                 $uselog = "";
  67.                         This determines whether you want to use the
  68.                         log or not.  If you do you will simply get a
  69.                         log of the Remote Host and the time they took
  70.                         the random link.  If you set this to '1' it
  71.                         turns logging on, otherwise it is off by
  72.                         default.  If you do turn this option on you
  73.                         must also fill in $logfile below.
  74.                 $logfile = "";
  75.                         This is the actual file system location of
  76.                         your log file.  It must be chmoded read/write
  77.                         (666) for everyone and placed in a directory
  78.                         with like permissions.
  79.  
  80. When you are done configuring these options you can move to the rand_link.html 
  81. file.
  82.  
  83. ----------------
  84.  
  85. RAND_LINK.HTML
  86.         This is just an example of a random link html file.  You can do 
  87. whatever you want with it, hack it up, remove it, etc.  It simply shows how 
  88. you can call the script.  The whole file really wasn't even necessary for me 
  89. to place in this package.  I could have just explained all you now need to do 
  90. is point your html browser to the rand_link.pl file.  So I could let users 
  91. take a random link simply by having the line in my html file:
  92.  
  93. <a href="http://worldwidemart.com/cgi-bin/rand_link.pl">Take a random 
  94. link!</a>
  95.  
  96. Its as simple as that.
  97. _____________________________________________________________________
  98.  
  99. Use this script freely.  All I ask is that you let me know the url of where 
  100. you are implementing this script and that you keep my name in it somewhere.  
  101. Not necessarily anywhere viewable by your users (It would be nice though), but 
  102. at least in the scripts.  Enjoy!
  103. _____________________________________________________________________________
  104. Matt Wright - mattw@worldwidemart.com - http://www.worldwidemart.com/scripts/
  105.